RtnAllocateFrame

RtnAllocateFrame returns a pointer to a RtxTcpIp Stack frame structure. RtnAllocateFrame is used to obtain a frame from the RtxTcpIp Stack. The length of the frame is guaranteed to be long enough to contain DataSize bytes of data (it may be longer). RtnAllocateFrame is normally called by an application to obtain a frame to put data into. It can also be used by the filter to place additional frames in the RtxTcpIp Stack’s receive queue or to send additional frames to the driver for transmittal. The RtnDecodePacket routine is used to access the data area, length and ndp fields of the frame.

Syntax

void * RtnAllocateFrame(
    char *DevName,
    int DataSize
);

Parameters

DevName

Zero terminated string indicating which device to allocate a frame from.

DataSize

Length required for the frame.

Return Values

A pointer to the RtxTcpIp Stack frame structure if the function succeeds, NULL if the function fails

Requirements

Header	Rtnapi.h
Library	Rtxtcpip.lib

| |